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600 

Class Hierarchy 

class jovo.lang.Object 

interface com.ibm.jtcApplicationMediator (extends conn.ibni.jtcJTC) 

class conri.ibm.jtcApplicationMediatorlnnpl (implennents com.ibnn.jtc.ApplicationMediotor, 

conn.ibnn.jtc.ViewListener. com.ibnn.jtc.RequestResponseListener) 

interface conn. ibm.jtc. Destination (extends conn.ibnn.jtc.JTC) 

closs conn.ibm.jtc.DestinotionlmpI (innplennents com. ibm.jtc. Destination) 

class jova.util.EventObject (implements jova.io.Seriolizoble) 

class com.ibm.jtc.PlocementEvent (implements jovo.io.Serializable) 

class com.ibm.jtc.RequestEvent (implements java.io.Serializoble) 

class com.ibm.jtc.TopEvent (implements java.io.Serializable) 

closs com.ibm.jtc.ViewEvent (implements jova.io.Seriolizoble) 
class com. ibm.jtc. Foctory (implements jova.io.Seriolizoble) 
interface com.ibm.jtc.JTC (extends jova.io.Seriolizoble) 
interfoce com. ibm.jtc. PlocementListener 
interface com. ibm.jtc. RequestListener 
interface com. ibm.jtc. RequestResponseListener 
closs jovo.long.Throwoble (implements jovo.io.Serializable) 

class jovo. long. Exception 

closs com.ibm.jtc.RequestException (implements java.io.Serializoble) 
closs com.ibm.jtc.VolidotionRuleException (implements jovo.io.Serializable) 
interface com.ibm.jtc.TopListener 

class com.ibm.jtc.Tronsporter (implements com.ibm.jtc.RequestListener, com.ibm.jtc.JTC) 
class com.ibm.jtc.VolidotionRule (implements jova.io.Seriolizoble) 
interface com.ibm.jtc.ViewController (extends com.ibm.jtc.JTC) 
interface com.ibm.jtc.ViewListener 
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ValidationRule jp jq ^ 1 200 
Voriobles / 



Nome 


Declorotion 


Description 


.copyright 


public static final String_copyright 


(c) International Business Machines Inc., 
1997 1998 1999. All rights reserved. 


NONE 


public static final int NONE 




COMPONENT 


public static final int COMPONENT 




FOCUS 


public static final int FOCUS 




VIEWEVENT 


public stotic final int VIEWEVENT 





, , , FIG. 12B '202 

Constructors 



Nonne 


Declaration 


Description 


ValidationRule 


public VolidotionRuleO 





FIG. 12D T 

* Given o list of doss nannes, apply each validation rule of the classes 

* to input string and return the fornnotted result. 
* 

* ©return the viewable formatted string. 

* ©porom clossNomes a comma-separated fully qualified list of concrete AbstroctRule classes. 

* ©porom input the input string to apply edit rules to. 

* ©exception VolidotonRuleException if there was an error in applying the edits. 

»/ 

public static String applyEdits{String clossNomes, String input) throws VolidotionRuleException | 
int commolndex = -1; 
int curlndex = 0; 
do I 

comma lndex=classNomes.indexOf(\\ curlndex); 
if (commolndex == -1) | 

commolndex = clossNomes. Iength(); 

String clossNome = classNames.substring(curlndex. commolndex).trim(); 
try I 

ValidationRule rule = (ValidationRule) Factory.newInstance(className); 

input = rule.edit(input); 
\ catch (VolidotionRuleException re) j 

throw re; 
\ catch (Exception e) \ 

throw new VolidationRuleException("Rule class"' + clossNome + "'not found."); 

I 

curlndex = commolndex + 1; 
I while (curlndex < classNames.length()); 
return input; 



I 



15/119 

0 AUSg90339US8 # 



O 

* k_ 
o 

CO 



O 

"S 

O 



CO 

o 



E 
o 



C O 

-— Q- 

CO 



o g5 .S 

I (/) 

CO o _ 

CO ^ ^ 

to £ Q- 
o o 



0^ 



-o 



O CO 



. <L) 

o 

CO a> 
E -o 



o 
E 



CO 
CO 

o ^ 



CO 

o 



^ -on ° 

CO g t 
o) ^ a> 

CO o ^ 

^ i 

-<n 

_o ^ 

<c . . 
^ E o 

<L> US 

^ Q 

o 

^ a> o 

1 



o 

X 



O. CO 

o o 
o -c: 



CO 
*"0 



o 

C7> 



CO 
o 

"en 
o 



CO 



" J 

cr»"S , 

CO Z3 

<u or 

i.i 



CO 

o 



Q. 
O 



^ o 

I& 

.E CO 
o o 

^ E 

cn c 

<^ S 

CO O 

cn o 
o 

o o 



CL O 
O 

O 
O CD 
CJ 
X 

CX>I 1 i 

E ^ 

to or 
c 



I 



CO 

.. Q> 

^ E 
o 

CD ^ 

c: CO 
o 



5=^ 
o 



.E 

CD )— ^ 

o in CO «^ 
E 03 o 



CD 



O 



o a? 
«= E 

o ^ S E 



o J? 

CO ^ 

a> _o 

o ^ 
^E 

CO CO 
CO c 

o o 



CO — ' 
<C CD 
CD 



<D 



cn 



- i 

o 3 

C_> CD 



-2 



CO 
— CO 
CD 

^ E 



o 



o 

X 



<D 

E ^ 

o 

Z Q, 

CT* CO Z3 

c= o or 

.S ^ 

CO ^ _ 
CO 

cr» CO 
.E * 



CD 



O 

E 



O- 
O 



CD 
CD 

E 

o o 

CO 



O 



O 
CO 













CD 

_o 


o 




czn 




O 


.E 


use 


CD 


"co 


CD 


'> 




-Q 


CD 


"3 








C 






o 






o 


<o 






c 








o 






CD 










or 




.E 


cn 




"co 


* ^ 


o 


"O 
QJ 


to 










"3 


Q. 


E 


E 





"co 
-o 

CD 

"o 
§ 

o .E 



o 
E 



CO O 



^ I 

P c 



„ CO 
<D 

I i 



3 

CD • — 

o 



c 

(D 

E 
_ai 
cx 
.E 

"co 
E 

CO 
CD 
CO 
CO 

_o 
o 



CO cr ^ 



Q 
<D 
O 
X 
LU 
<D 

,o 
"o 



<-> ij 



^ <D - 



CD 



c: 

CO .o 

S §-5 



C_) 

O ' 



CD 



CO 

o ■"" o 

CT»* 
CJ c o 

s 



CD CD rtir 

^ S ™ 

CO ^ cr E 
o >- 

Q_ CD 

c cn 
CO o 

.E •== CO o 



CO 



-o 1- o 

CD 

<D 

O Q <D 

fc O 
O >: C 
£ I 3 

£ a> o. - 

CD Q-.E O 
CO '-^ 



CO 



C3_ CO 



e- O 

— CD Li_I 

CO C= CD 

CO * </> 

EQ^ <u CO 

=5 E * 

" i 2 

<D <D V> _C 

CO ftg 1— 

CO ~ o 

o o • 

3 O O ^ 

CO c -o CO 



Co 



<D 

"o 
E 



CO .o 

■J §^ 

X 

T) I 

^ Z3 3 

CO Q-q: 
o '~ o 
o c o 

*:o .5 



CD 



E 



17/119 
AUS990339US8 



o 
o 

CO 

a> 



> 

CD 
CO 



cn 

CD 



oo 

CD 
<7> 



CD 

cn 



CO 
CO 

GO 



CO 



O 
I 



o 



o 



Q- 
O 



CO 
O 



<c 



<c 

CO 



CO 
CO 



or 
o 

eel 



or 



<c 
o 



o 



CM 



CO 



on 

Q. 



CO 



O 
c 



o 

c: 



CD 
> 



CD 



o 



o 
o 



o 



O 



"co 
o 



"oo 



"go 



o 

"co 



o 
"co 

o 



5 



13 



Q. 



-O 
Q- 



-O 
Q. 



"go 
o 
3 



"co 
o 



o 
"co 

o 



o 

to 



o 

"to 



o 



to 
o 



CO 

or 



CO 

-O 

o 



E 
o 



O 
O 
I 



O 



o 



o 



CO 

o 



in 



55 



CO 



or 
o 

or 



c:5 



or 
<c 



on 



Od 



CD 



o 



CNJ 



CO 



on 



18/119 
AUS99033.9US8 



CD 
CD. 



> 



CO 



o 
in 

£3 



O 



O 
CD 



CL> 

E 
o 



CO 
CO 



OL 



CO 
CO 



o 

CO 



CO 



CO 
CO 



CO 



CO 



a: 
O 
or 



CO 



or 
o 



CO 



CO 



o 
o 



CO 



CO 
CO 



CO 



CO 



o 

CO 



CO 

o 



or 

Q_ 



CO 

o 



Q_ 



CO 



Ql 



CO 

or 



CO 

:3 



o 

c: 



CO 



CO 



or 



CO 



o 

UJ 

m 



CI. 



CD 
cn 



CO 



CO 



CO 



Q_ 
O 



q 

CO 



Q_ 
O 



CO 



OH 



CO 
LU 



q 
"co 



or 



CO 
LU 



ZD 
CO 



q 
"co 

o 

Q- 



CO 



CO 



-2 

CO 



CO 



LU 
CO 



J2 
to 

o 



or 

LU 
CO 



19/119 
AUS990339US8 



C3. 



o 



"O 



o 



> 



Q_ 



CO 



CO 
CL. 



CO 



CO 
C_5 



"o 
o 



"co 
3 



o 
to 

3 



o 
a> 

CD 



Q- 



O- 



Ql 



Q- 



CL 



to 

O 
* ^ 

o 



E 
o 



O 
Q. 



S2 



O 



CO 



or 
o 



C=3 

o 



Q- 
O 

o 



o 



O 

UJ 

or 



CO 



or 



LU 

in 



20/119 
AUS990339US8 



o 

o 
cn 



o 
> 



> 



X5 



<L> 
> 



<i> 
E 
E 



o 



o 



CO 



CNI 

CO 



I — 
CO 



O) 



o 
o 



> 



Q_ 



>- 

UJ 
OH 



CO 
UJ 



UJ 

a: 



OH 

UJ 
CO 



CO 



CO 



o 
o 



o 
<u 



p 
"en 



"co 
o 



o 

to 



q 

CO 



q 

CO 



o 
"co 



o 

"co 



=3 



lo 



13 



q 

CO 

o 



"co 



=3 
Q. 



3 



O 

"co 

O 

lo 

Q- 



O 

"co 



Z3 



o 
"co 
o 

Ol 



"co 



o 

"co 



p 



Q. 



<D 

E 



o 



o 

o 
o 

-O 

"O 
<D 

"o 
"o 



o. 

E 
p 

"co 



o 



o 

X— 



O 



O 
O 

-o 
a> 

"o 
o 



CO 

-O 
O 



E 
o 



Q_ 



-< 
UJ 
OH 



CO 

I 

UJ 



OH 



OH 



C_5 

or 
<: 

UJ 
CO 



CO 
UJ 

o 
o 

ZD 
CO 



c7^ 

UJ 


OJ 






:ntt[ 


UJ 


UJ 

> 

UJ 


■ ■ ■ 


UJ 
> 
UJ 


UJ 


g 

UJ 


UJ 


> 


> 


> 



CO 



E 



o 
o 



Q_ 

E 
o 

"co 
E 



o 



21/119 
AUS990339US8 



O 

o 



o 
a> 



a> 

o 



o 

CO 

_a> 

*t3 
a> 

Q- 

co 



o 
o 



o 



o 



o 
"o 

CL> 
Q- 
CO 



O 



a> 



o 



o 
cn 

-o 
'o 

CD 
Q- 
CO 



CNJ 



cn 

CD 



CD 
> 
UJ 



cn 



cn 
c: 
o 
o 



> 



cn 



cn 
c: 
o 
C-5 



cj 

CD 



CD 



CO 
O 



O 



c_> 

<D 



CD 
> 
LU 

■> 
o 

CO 

o 



o 



p 
"5 



o 

CD 



(D 
> 

o 

CO 

r3 



o 



CO 



o 



c 
o 

"5 

o 
o 

CD 



CD 

E 
o 



CD 
> 
UJ 



CD 

o 



o 
cn 



o 

CD 



O 



> 



CD 



E 



CD 
CJ 



o 
cn 



CD 



> 

LU 
(D 



O 



<D 



> 

LU 



CD 



CD 



<D 



O 



O 

O 



o 
o 
E 



<D 
O 



O 
CO 



o 

CD 



> 

LU 
CD 

IS 

cx 



c 

CD 
> 
LU 

CD 



-o 

CD 



o 
o 



CD 
> 
LU 

CD 



CO 

o 





























M 
















ect 
















jO 




rne 














"53 


















3 












O 


cn 














"53 

CO 




"55 












~c 


CO 














lis is 
















CD 
> 
LU 


o 
% 

cn 
















cn 












loss 




















even 












o 
















fou 




CD 












c 


<D 














CD 


- 




























-o 


o 














rce 


CO 














CD 


CD 














3 


















o 














O 


TD 














"O 
















tn 
















O) 


CD 


so 












"£ 




















o 














CO 














cn 




CD 
k_ 














o 




























cn 




















CD 












CD 




























CD 

o 




















o 












erri 


eve 






r 








<D 


"o 


-o 








!vent C 


d 
_o 


rce Ov 


en the 


nned? 


o 

CD 




CD 


on. 


rce. 


fhen thi 


presen 


o 

CD 
> 




eveni 






O 


no 




ns 


E 








no 




CD 


CD 






o 
*o 


ent 


CO 


E 


con 


nsu 




O 


O 


cn 


E 




CD 

-c: 




cn 


o 


E 


> 


"c 


o 


o 




"c 














"O 


CD 


CD 






o 




CD 


CD 


CD 


"co 

CD 


'"cn 














> 


imes 


c 




"o 


> 


> 


> 




*o 


c 




O) 


a> 


a> 


CD 


CD 






CD 


CD 


CD 


.E 






o 


a> 




-c: 






> 












o 


CO 










CD 




(D 


CD 


CD 


CD 


CD 


CD 






CO 


;cripl 


isum 




3 


urn 


_cr 

CO 




CD 


> 
CD 


cn 


:£ 

CO 


CO 


cn 


CD 

-d 


urns 


: do 


cn 




* 














■« * 


' * 










CD 


CD 


o 


CD 


"oJ 




"£ 




cn 


3 


CD 


CD 


"SJ 




"oJ 




_C 




o 


OH 




ct: 




CD 




CO 


CO 


CO 


CO 


CjO 




1 


















































































CD 
































E 
































3 
































cn 
































































CO 








rce) 
























cr 








3 
























leo 








so 
























o 










.E 






















o 




O 


o 


c_> 
qj 




















CD 






O 


o 
























E 




bject doi 






-O 


cr» 




















CD 






O 


c 








;ume() 






o 


gelSourc 


E 
_o 


sConsi 


onsum 


lajor(in 


linor(in 


ource(i 


tomp(lo 








ons 


_o 


"o 








etc 






















cn 




n 


CD 


"55 


CD 


CO 
CD 








void c 


ct getD 




"SS 


Object 


gelTim 


booleo 


void s 


setDcti 


void s 


void S 


void s 


setTim 


g toStr 






o 




"o 


"o 


o 


C 


o 


o 




o 


o 


o 








o 


c 


-O 


c 


c 


c= 


c 


c= 


O 


c 


cz 


c 


*o 






























> 






































o 


C-) 


O 


CJ 


o 


o 


o 


CJ 


o 


O 


o 


o 


o 


o 


o 




o 


_Q 


_o 




_jO 




_Q 




_o 


-O 


_D 


_o 


_o 








CD 




3 


3 


3 


3 


3 


3 


3 


3 


3 


3 


3 


3 


3 






Q- 






Q_ 


O. 


CI. 


o. 




Q_ 


Q_ 


Q_ 




C3_ 


Q- 
















Q_ 

E 




-o 

CD 










o. 
E 








CD 






V- 


ce 


sto 


me 


uuni 






k_ 


ce 


sto 








;um 


_o 




O 




CD 


3 


cn 


_o 




O 




CD 




CD 


O 


*o 


C 


3 

o 


E 


cn 
c 


C 

o 


O 


*o 


_c 


no 


.E 


' w_ 




E 


cn 


Q 






(✓2 




o 


o 


Q 
















c 












o 

cn 














CO 




o 


o 


"£ 


"5 








CD 


CD 


"5 


"£ 


CD 


"55 










cn 






C7> 




CO 


CO 


cn 


cn 


cn 


CO 







22/119 
9 AUS99033gUS8 




23/119 
AUS990339US8 # 



CO 



o 

CO 



-o 

O 



-2 

<u 

E 
<u 
o 
o 

Q- 

o 
c 

(D 

O 
> 



o 



o 

"O 



O 



c 



no 



o 
> 



CO 
<L> 



O 

o 
o 



o 



CO 

o 



to ^ 
-2 — 

"o 
^ "a. 

.1? 

o ^ 
o ^ 

1-° 

cz o 
o 

o .o 



"co 

CO 



-2 •- 
"o 

o a> 

CO 

o 

o _o 

Q.-0 

<i: 
c 

03 a> 
o 

_^ a> 



en 
■> 



o 



-o 

<L> 



O 
TD 

TD 
CO 

cr» 

CZ 

o 
o 



O- 



<L> 

o 
> 



<u 
o 

Q_ 



CD 
> 

o 
E 



o 
> 



c 

' I 

"en 
<i> 

cr 
a> 

or 

o 

<L> 

> 
o 

E 
a> 



o 
> 



"go 



O 



cn 

> 
o 

E 



a> 
c 
a> 



> 

' o 

E 



o 
> 



CO 



O 
> 

o 

cn 

CO 

c 
o 
'co 

CO 



CO 



O 
> 



CO 



o 



<1> 

CO 



o 
> 



CO 

■ 3 
o 
<o 
a> 



CO 



o 
> 



"to 



<L) 
CO 



o 



CO 



o 
"o 
_o 
o 



CO 

o 



E 
o 



<L> 

"go 



E 
<u 
o 

Q. <D 



^ <L> 

E 



-2 
"to 



E 

<D 
O 
O 

O. 

o 



CD 
<D 

"co 



CO 
CU 
ZJ 
O" 

<u 

ct: 

"O CD 

o c 
a> 

.-^ 

o — 
> 

o 

O CD 

-K ^ 

o CO 

<D 

^ or 



CD 

c 
to 



CO 
CD 



CD 

o 



o 
o 



(D 
CD 
CO 

o 

"O 

o 



o 



Q. 



o 
o 



cz 

CD 

CD 
CD 

CD 



<D 
CD 

CD 



o 

"co 

_o 
o 

o 

Z3 

o. 



CO 

o 
*co 

CO 



CD 

a. 
"53 



CO 



o 
o 

V— 

to 
o 



CO 
CZ 

o 
"co 

CO 



<D 



O 
O 



CX 
O 



l.i 

o 7^ 



1 §^ 



1 

o 

CD 
O 

o 

o 
"to 
o 
o 



*co 



o 

o 
o 



o 
o 

"to 
_o 
o 



o 



o 



-o 
> 



CJ 

o 

CO 

_o 
o 

o 

CL 



CO 



'to 

CO 



CD 



<D 
CD 



<D 

E 
a> 
o 
o 

Q_ 

<D ^ — ^ 
> »^ 
O <D 

CD -Jii 

O 

^ <D 

e 

to 

_0 CD 

o E 

<D 

lo ^ 
3 Q_ 

cx^ — . 



<D 

c= 

<D 

to 



E 

<D 
<_> 
O 

Q_ 
CD 
> 
O 

E 







CD 




C 




Q> 








"K 












to 




CD 








O" 




CD 




ct: 




<D 




> 




o 




E 

CD 


ner 




CD 






'o 




> 






a3 






o 


CD 




"K 


to 
_o 




o 


to 






o 






o 




CD 






Q- 





CZ 
<D 

to 



CO 
CD 



<D 

<D 
> 
O 

E 

CD 



<D 
CD 

to 



CD 
C 

"K 

Q, 

o 



-S 
o 

> 

o 
E 

CD 

*o 



3 



CD 

-2 
"^ 
■_J 
cx 
o 

> 
o 

E 

CD 



to 



CD 

to 



o 

c: 



CD 

> 
o 

E 

CD 



O 
O 

to 
o 
o 

o. 



CD 
CO 

" t 

% 

CD 

> 
CD 
> 
O 

E 

CD 



O 
' CO 
CO 

"e 

CD 
O. 

O) 
-O 

o 



to 
o 



CO 

c 
o 



Qu) 

"S 

CO 



o 
o 

to 

jO 

o 



to 

CD 



CD 

o 



CO 
(D 



<D 
Q. 
O 



to 

CD 



CD 
O 



CD 
CO 

"O 

O 
> 

tj 
o 

k_ 

to 

-O 

o 
o 
lo 



CD 



GO 
(D 
O 



O 
CO 
(D 



CO 
CD 

o 
to 

<D 

"55 

to 

-o 
"o 



o 
o 

to 
_o 
o 

tJ 

lo 



CD 
_Q 
*CO 



o 

CD 

O 
O 

a> 
_o 
*to 



CD 
CO 



o 
> 



o 
o 

to 

-O 

o 
o 
lo 
cx 



to 

CZ 

o 
'in 

CO 



CD 
Q_ 



CD 
CO 



CO 
CD 



CD 
Q_ 
O 



CD 

to 



CO 
CD 

o 

CO 
CD 

CD 

to 



-O 

'to 

> 

"S 

CO 



24/119 
AUS990339US8 



"3. 

CO 

a> 



c: 



CD 

E 

CL> 
O 

_o 

Q_ 



c 
cu 



O 



CO 

V- 

CD 

"co 



CO 
CD 



CD 



c 

CD 



CD 
> 



CD 



a> 
"S 

CD 

o 

CD 
O 
CO 

o3 
"o 



o 
o 

CO 



■o 

CD 
"O 

O 

CD 
jQ 



CD 



O 
O 
CO 



o 
o 



CD 



CD 
> 
CD 

CD 



C 
CD 
> 
C 

o 

CJ 



-O 
CO 



"o 

CD 
O 
CD 
O 
CO 

o 

CD 

E 

c 
,o 

"o 
o 

"q_ 
ex. 
o 



CD 

> 

CD 



CD .V? 



CD 

O 
CD 



CD 



CD 
> 



O 



CO 



o 
E 



o 
■o 

E 
_a) 
to 

CO 
CD 



CD 
CJ 

CD 

O 

CO 



CD 
> 



CO 
CD 

CT 
CD 

o 

CD 

CD 

O 

CO 



CD. 



o 
o 

"q. 



o 
o 
o 

CD 



CO 
CD 

c 
"co 



CD 

E 

CD 
O 

_o 

Q. 



CD 



"o 



CD 

c 

CD 



O 



CD 

c 

Q 
O 

"o 



CO 
CD 

"co 



CO 
CD 



CD 



O 
CD 



CD 



CJ 



O 



CO 

a3 

CO 

*> 



o 

CD 



CD 



CJ 



CO 

a3 
"o 



o 
*> 



CJ 
CD 



CD 



CJ 
CD 



O 

\ 

Q- 



CO 
<D 



O 
O 



o 



CJ 
CD 



O 
CD 



5 
O 



CJ 
CD 

o 



<J 

CD 

"o 



CD 



CO 
<D 



C 
CD 
> 
LU 

to 

CD 



<D 

a: 



CJ 

a> 



CO 
CD 

JO 

o 



CD 

E 
o 



CD 
CD 



CD 

E 

CD 
O 

CL 



CO 
<D 
CD 
CO 

Q_ 
O 



CD 
C 
CD 



CO 
CD 



CO 
QJ 
CD 

* > 



CO 

a> 



o 



CO 
CD 



O 
CJ 

Q- 
O 



O 
O 



c 

CD 
> 
UJ 

to 

CD 



5: 



CD. 



o 













-o 






c 






o 




CD 






-o 






O 


CO 




CJ 


CD 










*o 






Q> 


t75 










"c 






CD 






E 






orn 


reo 




CJ 




















c 






ee 




on 






< 


t3 




CJ 


_o 










m 


CJ 














c 


o 


CO 


o 








CJ 






— ^ 


CO 


o 


to 




CO 


c 




CD 


o 


o 


Q 


CJ 


















"q. 






_E 












o 












"o 












CD 


















o 












"S 






<J 










o 


Q- 






<c 




O 






o 


CJ 




CJ 






CD 






CD 


Q- 
























-2 
























CD 






























"o 




CD 


o 




E 






o 













25/119 
AUS990339US8 



O. 



o 

CO 
CD 



C 



c: 
<D 

E 
cu 
o 
_o 

Q- 

o 



"tn 
<u 
r3 
cr 

o 
-o 

5 



C 

' I 

cx 
o 



-o 

5 



c 



5 







<u 






CO 


~o 




o 




_o 




"o 




"o 


— 








CO 


* i« 

o 


o 


cu 


"5 








QJ 








O 








"o 


"o 


o 


**o 


Q. 

<c 


c 




o 








"o 


O 








CO 




a> 


<i: 






"o 




ontr 






O 


% 


<D 


CD 


C-5 


> 



a? s 

<U CD ^ 
O E 



»^ 

<D O 

> 

2 .E - 
™ o 

^ a> 13 
^ cn CO 

CD 

<«- 

— CO 

o ^ 
o 



CO _ 

CO 
- CD 



O 



(D 

o S 1 

CD Q. > 

CO o 



q3 <^ <D 

"o ,cn c 

o o 

O O <J 

C CO -o 

^ ° s 



S .5 

.5 S 1^ 

Q- cn 
<C CD 

S 

.9 "O 

-3 C= <D 
O O h= 

o ^ 

■— CO 
Q.^ -co 

<i: o 

_^ "c 

* — 



X 
CD 

a3 
o. 

=3 

cn 

CD 
CO -i£ 
•— o 

£ o 
«J 

E <u 



a> 

. cn 

C CO 

o -2 
CP o 

-o ^ 

CD _ 
CO o 



CD 

CD 

o > 
o 



\ 

CD 

CD 

E 

CD 
O 
O 
CD- 
CD 



O 
C 

o 

o 
c 
>^ 

CO 

I 

CO 

CD 

~co 



CO 
CD 

CD 

or 



CO 
O 



CJ 



cn 
o 



CD 

c 

CD 



CO 

CD 

O" 

CD 

or 



o 

CD 



CO 
k_ 

<D 

■ I 

CI. 
O 



CD 

e 

CD 



CD 



(D 



O 



"o 

CD 
O 
CD 



t3 S2 

S S L 

.E o o 

£ ts 

^ 1^ 
° o <c 



O CO 



o 

CD 



o 

CO 

O) 

o c: 

3 ^ ^ 

CD > 



Co 



o. 

e 

~o 

CD 



O 
O 

"q. 



CD 
CO 
CD 

cz 

CD 
CD 

E 

CD 
C_> 
O 
CD- 



CD 

c 
a> 



c 

CD 

E 

CJ 

Q- 



-o 
> 



CD 

CD 
CO 



CO 
CD 

o 

CD 

or 



CD 
CD 

"co 



CD 

a> 
c 

CD 
CO 



CO 
CD 

O" 
<D 

-o 

"O 

o 



o 
> 



CO 

Q_ 
O 

o 



c 
o 

"o 
_o 

C-> 
<D 



CD 
CD 



CD 
C 



<D 



<D 
C 

■> 
o 

> 

"o 
c 



o 

<D 

-o 

"o 
> 



CO 

o 



CD 

E 
o 



CD 
C 

-25 
"co 



CD 

E 

CD 

_o 

CD_ 



o 

CX 



CD 
C 
CD 

"co 



CO 
CD 
Z3 

or 
■o 
■o 
o 



o 

j5 



CD 

-23 

o 
I — 

■o 

O 



-O 



CD 

> 
o 



-Q 



X 
CD 



O 
> 

o 
lo 

3 
Q. 



O 
CD 



CD 

E 

CD 
O 
O 

Q- 



CD 

E 

CD 
O 

_o 
Q- 

CD 



o 



E 

<D 

O 

CD- 
CD 



CD 
> 
CD 



CD 
> 



CO 
CD 
3 

cr 

CD 



c 

CD 
> 

"co 

CD 
3 

cr 

CD 

on 



•o ^ 

> UJ 

.i i 

cr 

CD 

"O CO 
CD ^ 



CD 
> 
UJ 

~co 

CD 

3. 

cr 

CD 
CD 



CO 



c o 

CD 

> CX 

<D oi" 
o 

X 

£ y 

3 

cr 

c 2 

CD jC 



CO 

CD CD 
3 = 

cr o 
5 cj 

2 a3 
_aj 

o '—J 
> CD 
CO 



CO 

CD ^ 

"o S 

<1> 3 



CD 
> 
CD 



CD 
> 



O 



CD 
> 



O 



CD 



O 
CD 



C 
CD 
> 
CD 



CD 
> 

CD 



CD 
> 
LU 

CD 



o 



CD 

cr> 

no 
CD 



CO 
O 



O 
O 



Q. 



o ^ 



c: 

CD 
> 
LU 

"co 

CD 
3 

CD 

CD 



CD 
O 
-23 

"o 



CD 



O 
CD 



CP 



lo 

3 



O 



CD 



CD 
CZ 
CD 



CD 
> 



CD 



CD 



CD 



CD 
CP 



CO 
O 



CD 
CP 



26/119 
AUS990339US8 



o 

CO 



Z5 

o 



o o 



<C 
-o 
o 

a> 
"o 



a> CO 
1 o 

^■^ 1 



o 



<I> 



2 

o ^ 
^ o 

rsj 

o 



o 
cu 



0*0 

*<o o 

^ ."^ 
O X 
QJ 

O 

O C 



<t: o 

<D CO 

£ q3 

CI 

a> <^ 



o 
o 



i s 

to 

CO 

o 



o 

o ° 

o a> 



CD 



cn 
o 

o 
cn 



> 

- I ■ I 

fc <u 
o o 

is ^ 



c o 



o ^ 
a> • — 

O <D 



-o 

CU 

o 
c 

"o 



o 



o 
o 



^ 52 
cn _a) 

CP 8 



o > 

o o 

CO 

a> o 



CD O. 



cu o 
o <u 

r— w_ 
. — CO 

cn 



cn 

> c 

3 



CO 



o o 
— cn ^ 



o c 



CO 

-S? — 

2 j;? e 



CD ^ 

■i - 

O 

> £ 



^ ^ 

CO 



o •> 



^ CD 
CD 

<L> 

cn ^ 

"o -o 
<u o 



cn 



cn o >v±; 
•— ^ CD CD 

i= :£ E 



CD 

E 



o 
■> 

cn 

CO 

o 

CJ 
-O 

cn 

CD 



CD 



cn 

o o 
"c "O 



-C CD 

Jo 

O CO 

to ^ 



o o 
o .9 

CD -o 



CD 

d 
cu 



E 

CD 
O 
O 
CL 



cn 

CD 

> 
o 

E 

CD 



O 

o 



ex. 

o 

cu 



o 
o 

<3: 



o 
o 

c_> 

CD 



CO 
CO 



CP 



CO 
o 



CD 



o 

(D 



CD 

"o 



Q. 



o 
o 

o 



CD 



C3 
O 



o 



o 

IS 
3 



tr: o 



CD 
CO <-> 

c: X 

O LU 

a> o 

S Lj- 

il 

O CO 
Q_0 

<a: cn 
'o , . 



CD 
O 
X 
LU 
CO 

cn 

CD 

o 

:^ 
o. 

CT 
CD 



C 

o 
"q. 

CD 

o 

X 



.9 c= 
"5- -J 

— ' LxJ X 
CO -O LU 

^§ 

C-) o ^ 
* c3 = 

> cn c: 
.tir S o 
cz o 

CD 



o S o 

E o 

o ^ ^ 

■ — cn o 

o — 



cn 

CD 



CO Q 

CD - 

E o 



13 
CL C-> 



CO 

"o 



CO o 
cn 

o v> 



CD 
-O 

o 

LU 

cn 

c 
o 

CD 
O 

o 
o 



s 

cn 

o 

o 
o 

o 

CL 



CD 

'cn 



O 

CD 

o 
o 



cn 
■o 
o 



CD 

E 
o 



cn 

CO 



CD 

"5 

cn 



o 
o 



CD 
CP 



O 
CD 



CD 

_o 

O 

c 



cn 



*cn 

> 
cn 



CD 



> 

LU 

CD 
> 

cn 
cn 

CD 

cj 
o 



-o 

'o 
> 

o 
"cn 
o 
o 



CD 
> 
LU 

CO 
CD 
CJ 
O 



o 



O 
CD 



cn 



> 



CO 
CD 



CD 
CI 

a> 



CD 

"cn 



CD 

E 

CD 
O 

_o 

CL 



CD 

d 

CD 



CD 
CJ 
O 
Q_ 

CD 
> 

o 
E 

CD 



"O 

'o 



O 
CL 

a3 
c 

CD 

"cn . 



CD 

E 

CJ 

o 

Q- 
<D 

§ 

E 

<D 



27/119 
AUS990339US8 



CO 



c: 

<L> 



CO 
<L> 



a> 



CO 
CD 
> 

o 
E 

O) 



to 



CO 

> 
o 

E 
<u 











o 


< — 

CI 




a> 








CO 


CO 


>^ 


o 


CO 








o 






"co 










crt 


cr 




QJ 


c/> 


w 


CO 


US 


CL> 




o 




cr 




o 






■ * 






nc 




>^ 




CO 




o 








on 






<L> 


CO 








o 






m 


<D 


_Q 






cf 


_^ 


.o 


o 




o 










o 


-o 


X 


qj 


LiJ 


"o 









CO 



CO 



CO 

o -cr 

c: 

o 

CO o 



CO _c: 

CO 

^ O) 



8 3 



o 
o 

f 1 

-o --^ o 
o c: — 

p CO 

^ ^ CO 

^ ^ o 
_ o o 



CO ^ c 

cz o * 

•— -o 

<i> ^ 

E o 

^ CO 

^« o 

"O <^ to 

o o 

£ <u 

E E 

f= cir :5 



o 

o 



"o 



O 

a> 



8 o 

O <U 



CD O. 
to <C 

= -o 



CO 

g 
"co 

E o 

CD 

CO -§ 
— o 

"I 

o 

-o c 
>. ° 

CO "o 

CO o 
CD 

CO o 



CO 
CD 
• — fc— 

o 

QJ 

o -o 

*— CD 
CO O 
O CJ 

o 

Q. 



o 

CO 

<D C 
O 



CD 

"53 c 

CO o 



CO 

CD ^ • 
e O 
So 

CO TD 
CD CD 

ct: s 
v> .o 

= "o 
o o 



<C 

o -o 

^ ! 

o 

CO 

s § 
i.l 



<D 73 

CD 

"55 c 

CO o 



o 

CD 



CD 
CO 



"o 



O 
CD 

> -2 

O <^ 
CD S 

cz o 
o 

CJ 



-Q 
*CO 
■> 

"5> 

CO 



■o 
o 



o 

C_3 



C_J 
<D 



<D 



.E 

'"O 

o ^ 

9^ c: 



CD 



13 CO 

^ <^ 

o 

CO ^ 

CO Q- 

<D 

O CD 55 

2 iS S 

QJ CD 

<D n) <D 

~a5 



CD 
> 



O 
CJ 



<t: CO » 



CD 

c 
CD 



CD 
CD 

"co 



CO 
QJ 

QJ 



CD 
C 
CD 



QJ 
CD 

to 



QJ 



CO 
QJ 
13 
CT" 
QJ 

QJ 

> 
o 

E 

CD 



O 



o 



QJ 

a> 

CD 

g 

> 
o 

E 

CD 

-g 
o 



o 
o 



CJ 

CD 



g 

Z3 
C3_ 



g 

C-> 



CO 
QJ 



CD 
CJ 
X 
UJ 

to 

QJ 

o- 

QJ 

cz 
o 

~Q_ 
CD 
O 
X 

LU 

to 

QJ 
CD 



O 
> 



CD 
CO 



CO 
CD 



c 

CD 
> 
UJ 

to 

CD 

cr 

CD 
CO 

c 
o 

OL. 
CO 
CD 

CO 
QJ 
Z3 

o- 

CD 



O 
> 



•g 



o 

g 

o 



g 

CD 
CZ 

_g 

"3 
_g 

<: 



3 



g 



g 



Z3 



O 
> 

g 



CO 

c 
o 
'co 

CO 



Q> 

CD 

jO 

CO 

o 



CO 
CO 



CD 

a. 
"53 

CO 



o 
> 



CO 
CD 



CD 
O 



CO 
QJ 



CD 
O 



CO 
CD 



QJ 

a. 
o 



CD 
CO 

"g 

"o 
> 



Z) 



g 

Q- 



CD 



:3 



QJ 



m 

CD 
CJ 

o 

CO 
QJ 

CO 
CD 
O 



o 

CO 
CD 

"5> 
CO 

-g 

"o 
> 



g 

Q- 



QJ 

"o 

"c 
o 

g 
■> 

_g 



o 

QJ 

>^ 



CD 
CO 

"g 

'o 
> 



_g 

'co 

■> 

o 
_g 

o 
o 

_o 
*co 



QJ 
CO 

"g 

'o 
> 



g 



g 



g 

Co 
g 
lo 

Ol 



QJ 



CD 



QJ 

E 



CD 
Q_ 



CD 
> 



CD 



O 
> 



CO 
"O 

o 



CD 

E 
o 



CD 
C 
CD 

to 



CO 
QJ 
Z3 
O" 
CD 

QJ 
> 
O 



QJ 



CD 
CZ 
CD 

to 



g 

> 
o 

E 

OJ 



CZ 

o 



CD 
O 
X 



CO 
CD 
Z3 
CT 
QJ 



CD 




CO 




CZ 




o 




a. 




CO 




CD 












"co 




QJ 




Z3 




O" 




QJ 









■o 

CD 



CD 
CO 



CO 

c: 
g 
"co 

CO 



CD 

CD 
CO 



CO 
CD 



QJ 
Q_ 
O 



CD 
CO 



CO 
QJ 
O 



O 
CO 
QJ 

CD 
CO 



_g 

_Q 

"co 

> 

"qj 

CO 



<zn 



CO 

o 



CD 

E 



CD 

"c 

CD 
> 
UJ 

g 



28/119 
AUS990339US8 



1706 



AoDlicotionMediotor Impl.exitf ) : AUS8- 1999-0694 
A* 

* Exit the ApplicotionMediotor by exiting oil ollocoted ViewControllers 

* and ApplicotionMediotors. All dota is set to null, and lists are 

* destroyed. An 'exited* ApplicotionMediotor cannot be used ogoin. 

* If this nnethod is overriden in o subcloss, be sure to invoke 

* super.exit(); 

public void exit() \ 

synchronized (this) { 

/* Used for style 1 event dispotching. Leave this code connnnented. */ 
//if (this.eventthread !=null) | 
// try I 

// eventThreod.stop (); 

// I catch (Exception e) | 

/* Used for style 2 event dispatching. Leave this code comnnented. */ 
for (int i = 0; i < runningThreads.size(); i++) | 

((ApplicotionMediatorThreod) runningThreods.elennentAt (i)) .stop(); 

runningThreods.rennoveAIIEIementsO; 
viewListeners.renaoveAIIEIements(); 
try I 

for (int i = 0; i < viewControllers.size(); i++) | 

(fViewControllerl viewControllers.elennentAt(i)) .setEnabled(folse); 
((ViewController) viewControllers.elementAt(i)) .exit (); 

for (int i = 0; i < applicotionMediators.size(); i++) | 

f(ApplicationMediotor) opplicotionMediotors.elementAtfi)) .setEnabled(false); 
((ApplicotionMediotor) opplicationMediators.elementAt(i)) .exit(); 

I catch (Exception noProblem) | 

viewControllers = null; 
opplicotionMediators = null; 
runningThreods = null; 
runningThreods = null; 
doto = null; 

^ FIG. 1 7F 
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ApplicotionMediotorlmpl.cleorO : AUS8- 1999-0694 
A* 

* Clear the ApplicotionMediotor by cleoring all allocated ViewControllers 

* and ApplicationMediotors. All data is set to null, but lists ore 

* not destroyed. A 'cleared* ApplicotionMediotor can be used ogoin. 

* If this methed is overriden in a subclass, be sure to invoke 

* super.cleorQ; 

V 



public void clear() j 

synchronized (this) \ 



/* Used for style 1 event dispotching. Leave this code connmented. */ 
//if (this.eventthreod != null) | 
// try I 

// eventThreod.stop (); 

// \ catch (Exception e) j 

/* Used for style 2 event dispatching. Leave this code connmented. */ 
for (int i = 0; i < runningThreads.size(): i++) | 

((AppiicotionMediatorThreod) runningThreods.elennentAt (i)) .stop(); 

runningThreads.rennoveAIIEIements(); 

// 
try { 

for (int i = 0; i < viewControllers.size(); i++) \ 

((ViewController) viewControllers.elennentAt(i)) .setEnabled(false); 
((ViewController) viewControllers.elenaentAt(i)) .clear (); 

for (int i = 0; i < opplicationMediotors.size(); i++) | 

((ApplicotionMediotor) opplicotionMediators.elementAt(i)) .setEnabled(false); 
((ApplicotionMediotor) applicotionMediotors.elementAl(i)) .cleor(); 

I catch (Exception noReolProblenn) | 

ViewControllers = null; 
opplicotionMediotors = null; 
data = null; 

viewListeners.rennoveAIIEIements(); 



FIG. 1 7G 
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A* 

* Initolize the ApplicotionMediotor using the listeners of on 

* existing ApplicotionMediotor. 

*/ 

public void init(ApplicationMediotor oppiicotionMediotor) | 

if (oppiicotionMediotor instonceof ApplicotionMediotorlnnpl) | 

ApplicotionMediotorlnnp! o = (ApplicotionMediotorlmpi) oppiicotionMediotor; 
requestListeners = (Vector) o.requestListeners.clone(); 
plocementListeners = (Vector) o.plocennentListeners.clone(); 
topListeners = (Vector) Q.topListeners.clone(); 
oddViewListener(o); 



initQ: 



FIG. 1 7H 
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* When new doto orrives oilow the ViewControllers 

* and ApplicotionControllers to be refreshed also. 

V 

public void refresh(Object doto) \ 
this.doto = doto; 
try I 

synchronized (viewControllers) | 

for (int j = 0; j < viewControllers.size(); j++) | 

((ViewController) viewControllers.elennentAt(j)). 
refresh(doto); 

j cotch (Exception noReolProblenn) | 
try \ 

synchronized (opplicotionMediotors) | 

for (int j = 0; j < applicationMediotors.size(); j++) \ 
((ApplicotionMediotor) opplicotionMediotors. 
elementAt(j)).refresh(dQto); 

I cotch (Exception noReolProblem) | 



FIG. 1 71 
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1714 

* A ViewEvent is delivered. Process it using Threading style 1 or 2. In 

* the end. the processViewEvent will be colled on the subcloss. 

V 

public void viewEventPerfornned (ViewEvent e) \ 

/* Used for style 2 event dispatching, start on inner closs thread » 
ApplicotionMediotorThread t = new AppiicotionMediotorThreod (e); 
runningThreads.oddElennent (t); 
t.stort (); 

/* Used for style 1 event dispatching. Leave this code connnnented. 

//ViewEvent saved = saveViewEvent(e); 

//if (eventThreod == null | | leventThread.isAliveQ) j 

// finished = false; 

// eventThreod = new Thread(this); 

// eventThreod.stort (); 

//I 

//synchronized (this) | 
// notifyO; 

I 

FIG. 1 7 J 



1714 
/ 

* This method is used in style 1 threoding. Rename this to run () 

* ond uncomment the code os described in the class jovodoc. 

*/ 

public final void run2 () | 

/* Used for style 1 event dispatching. Leave this code commented. */ 

/* 

while (true) | 

ViewEvent event = null; 
event = getViewEvent (); 
if (event != null) \ 

hondleViewEvent (event); 
( else I 

woitForEvent (); 

if (finished) | 

// something went wrong with the thread so hose this loop 
break; 

^ FIG. 1 7K 
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1714 

♦ Privote doss to handle executions of ViewEvents () on another threod. 
private class ApplicotionMediotorThreod extends Thread \ 

/** 

* The current event 

**/ 

private ViewEvent event; 

/" 

* Create an ApplicotionMediatorThreod to process the ViewEvent 

**/ 

public ApplicotionMediatorThread(ViewEvent event) | 
super (); 

this. event = event; 

I 

/** 

* Just call the hondleViewEvent nnethod that the subclass will override 

**/ 

public void run () | 

processViewEvent (event); 

^ FIG. 1 7L 



1714 

/ 

* Save the current ViewEvent on a 0 

V 

private final ViewEvent soveViewEvent (ViewEvent e) | 

/* Used for style 1 event dispatching. Leave this code comnnented. */ 
//return viewEventQueue.odd(e); 
return null; 

I 

/- 

* Method: return the first view event saved. Used by the Q'ing system. 

V 

private ViewEvent getViewEvent () j 

/* Used for style 1 event dispatching. Leave this code connmented. */ 
//return (ViewEvent) viewEventQueue.remove(); 
return null; 

^ FIG. 1 7M 
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Tronsporter.requestEventPerformed(ReQuestEvent) :AUS8- 1 999-0693 

A* 

* Submit Q synchronous request. For each Destination that is listening for 

* the current fonnily of RequestEvents (the nnojor code), send the RequestEvent 

* to the Destinotion for processing. If there is a problem, throw 

* 0 RequestException. Continue processing the RequestEvent os long 

* OS a RequestException is not thrown by o Destinotion ond the RequestEvent 

* is not consumed. 

* <p> 

* If tagging is enobled. then append a status tog to the RequestEvent. 
♦<p> 

* Destinations are processed in the following FIFO order: 

* 1- All using (priority). 

* 2- All using o major code. 

* 3- All using 
*<p> 

* ©exception RequestException if the Request can't be submitted 

*/ 

public void requestEventPerformed(RequestEvent request) throws RequestException | 
if (lenabled) { / 
throw new RequestException(**Transporter disabled"); 

I 

/* Try to tog the request ♦/ X 
if (tagging) ^2606 
request.setStatus(request.getStatus() + "[Transporter]"); 

/* Process PRIORITY, major and then WILDCARD destinations */ 
processDestinations(request. getDestinotions(PRIORITY)); 
processDestinatIons(request. getDestinations(request.getMajor())); 
processDestinations(request, getDestinations(WILDCARD)); 

' FIG. 26 F 

/•• 

* Submit on asynchronous request. See the synchronous 

* requestEventPerformed for more information. 

*/ 

public void requestEventPerformed(RequestEvent request. 
RequestResponseListener caller) throws RequestException | 
if (lenabled) | 

throw new RequestException("Transporter disabled"); 

if (tagging) 

request. setStotus(request.getStatus() + 

"[Transporter osync.]"); ^2608 

//start on inner class thread 

TronsporterThreod t = new TransporterThread(request, caller); 

runninqThreads.put(request, t); 

t.stortO; 

^ FIG. 26G 
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2610 

Tronsporter.TronsporterThreod :AUS8- 1 999-0693 

A* 

* Private class to handle executions of submits() on another 
thread. 

**/ 

private class TransporterThread extends Thread } 

/** 

* The current request 

A* 

private RequestEvent request; 

A* 

* The caller of subnnit that we will coll back 

**/ 

private RequestResponseListener caller; 



A* 

* Create a transporter thread 

public TransporterThread(RequestEvent request. 
RequestResponseListener caller) j 
super(); 

this.request = request; 
this.coller = caller; 

I 

A* 

♦ Just coll the synchronous version of 
requestEventPerformedO 

*v 

public void run() | 
try { 

requestEventPerfornned(request); 

caller.requestResponse(request); 
I catch (RequestException yikes); \ 

caller.requestException(yikes); 
I finally j 

runninqThreads.rennove(request); 

FIG. 26 H 
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RemoteDestinotion.requestEventPerformed(RequestEvent) :AUS8- 1 999-0704 

A* 

* Process request event. 
« 

* <P>PRE: None 

* <P>POST: None 

* ©porom request the RequestEvent object to be processed. 

* ©exception RequestExceptiori if there was on error during the 

* processing of the event. 

*/ 

public void requestEventPerfornned(RequestEvent request) throws 
RequestException | 
try I 

Method nnethod = null; 
if (session == null) \ 

// get home interfoce. 
Context ctxt = getlnitiolContext(); 
Object home = ctxt.lookup(request.getMajor() + 



"SessionHome"); 



I 



method = home.getCloss().getMethod("create". null); 
session = method.invoke(home. null); 



//get method on home object and invoke it. 

method = session. qetClass().getMethod(request.getMinor(). 

new Closs[] fObject.class|); 
request.setDato(method.invoke(session, new Object[] 
|request.getData()|)); 

if {request.getMinor(),equols("remove")) j 
session = null; 

I catch (InvocotionTorgetException te) | 

throw new RequestException(te.getTorgetException()); 
j catch (Throwable t) | 

throw new RequestException{t); 

2806 

FIG. 28D 
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Nome 


Declaration 


Description 


^copyright 


public stotic final String_copyright 


(c) International Business Machines Inc.. 
1997 1998 1999. All rights reserved. 



FIG, 29A 2900 
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View Controller 
( START ) 



Select screen 



Create class 



Override init() method 
replace with code to 
create, initialize and 
layout graphicol 
connponents 



I 



Override 
refresh() method 



Override 
clear() method 



Add view controller 
as components 
event listener 



Implement 
event listeners 



Use volidation 
rules to validote 
user input 



Create and fire 
ViewEvents 



C END ) 

FIG. 31 



Create Validation Rule 



( START ) 



Choose business 
validation rule 



Create class 



Override edit() 
method 



Override 
normalizeO method 



■3200 



3202 



-3204 



3206 




Validation 

rule 
exception 



( END ) 

FIG. 32 



Create a ViewEvent 
( START ) 



3210 



Create interface to 
ViewEvent codes 
in applicotion 



3300 



Create instance 
of ViewEvent 



Send ViewEvent 



■3302 
3304 



( END ) 

FIG. 33 
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3400- 
3402- 
3404- 
3406- 

3408- 

3410- 
3412- 



Creote 
ApplicationMediator 

( START ) 



Choose function 



Create class 



Override init() nnethod 



Create ViewControllers 



Override process 
ViewEvent() nnethod 



Create RequestEvents 



Involve refresh 



I 



C END ) 

FIG. 34 



Create RequestEvent 
( START ) 



Create interface 
to contain strings 
of nnajor and minor 
codes of RequestEvents 



Create instance 
of RequestEvent 



Send event using fire 
RequestEventO nnethod 



I 



( END ) 

FIG. 35 

Create a Destination 
C START ) 



Choose destination 



Creote doss 



Override init() nnethod 



Override 
requeslEventPerfornnedO 
nnethod 



Override 
concelO nnethod 



Override 
finalizeO method 



( END ) 

FIG. 36 



3500 



3502 



■3504 



-3600 
■3602 
-3604 

■3606 

■3608 
3610 
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3700-^ 

3702- 
3704- 

3706- 
3708- 



Creote TopListener 

Create class thot 
contains or is in the top 

fronne of opplicotion 
ond implements interfoce 



Creote exit() method 



Creote launch() 
method 



Creote messoge() 
method 



Creote title() method 



( END ) 

FIG. 37 



Creote 
PlocementListener 

( START ) 



Creote type 
of placement 



Creote doss 
implementing 

PlocementListener 
interfoce 



Implement 
plocement method 



■3800 



■3802 



-3804 



( END ) 

FIG. 38 
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4000- 

4002- 
4004- 
4006- 

4008- 
4010- 



4012 



Basic Operation of a ViewControllerlmpI 
C START ■) 



Implement 
the ViewController 
Interfoce 



Implement 
the JTC Interface 



Add specific methods 



I 



Create and 
compose the GUI 



Return "yourself" 
in getComponent 



Return permission 
keys, resources and 
properties when osked 



Update permission 
keys, resources and 
properties when asked 



FIG. 40 







Handle internal 
AWT events 






Validate and 
format data fields 






Issue ViewEvents for 
semantic interpretation 






Return the AWT 
thread immediately 






Hondle refresh colls 
to update the GUI 






Access the data 



■4014 

-4016 

-4018 

-4020 

-4022 
4024 




4026 7^,0 
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4100- 



4104- 

4106- 
4108- 

4110- 



4114- 

4116- 

4118- 
4120- 



( START ) 



ApplicotionMediotor 
receives ViewEvent 
from ViewController 




Create PlocementEvent 
with proper mojorCode 



Fire PlocementEvent 



Invoke PlocementListener 



PlocementListener 

receives 
PlocementEvent 




mojorCode = = 
PlocementHTML 

9 

4112 ^ 



Coll toHTMLO on 
ViewController component 



Tronslote View 
components into 
HTML components 



Creote ond piece 
OtherAlternoteView 



-4124 



Generate HTML output 



Send HTML output to 
client Browser for display 



( END ) 



FIG. 41 
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ViewEvent and ViewListener Usage 

— ► Usage from o ViewController 

public void actionPerformed(ActionEvent e) \ 
if (e.qetSourceO == nextButton) | 

ViewEvent ve = new ViewEvent (this); 
ve.setMQjor(ViewEvent.NEXT); 
fireViewEvent(ve); //notify 
ViewEvent listener 
return; 



FIG. 42 



— ► Usage fronn ViewListener (i.e. ApplicctionMediotor) 
//odd myself as o listener 
customerDetailsViewController.addViewListener(this); 

//later, we ore colled bock on this method to handle the 
ViewEvent 

processViewEvent (ViewEvent event) \ 
//do something 
switch (event.getMojorO) | 

cose ViewEvent. NEXT: //... 

break; 

cose ViewEvent. OK: //... 
break; 



FIG. 43 
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VolidationRules Usage 

Exomple Chaining 
//each rule 

String range = "conn.xyz.jtc.RangeChecker"; 
String nnoney = "conn.xyz.jlc.AccountMcney"; 

//build the chain of rules 
String[] rules = jrange, nnoney|; 

//get the value to validote 
String value = textField.getTextQ; 

try I 

value = applyEdits(rules. input); 
catch (VolidotionRuleException ouch) j 

//the value is validated and formatted, redisplay 
textField.setText(value); 

FIG. 47 

ViewControllerBaselmpI 

For exonnple: 

♦ inheritance 

public class ViewControllerBoselnnpl extends JPonel \ 
public Component getComponentQ { 
return this; 

' FIG. 48 

♦ delegation 

public class ViewControllerBaselmpI implements ViewController 

XYZ xyz = new XYZ(); 

public jovo.awt. Component getComponent() \ 
return xyz; 

public void setEnabled(boolean e) \ 
xyz.setEnabled{e); 

public void setVisible(boolean v) | 
xyz.setVisible(v); 

' FIG. 49 
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( START ) 



5200- 
5202- 
5204- 

5206- 
5208- 



5210- 



5214- 



5216- 



5218- 



5220- 



5222 



Implement 
ApplicotionMediotor Interfoce 



Implement JTC Interfoce 



Add 

ApplicotionMediotorlmpI methods 



Create ViewControllers 
using initViewControllers 



Use InitApplicotionMediotor 

to create other 
ApplicationMediators 
as necessary 



Listen for ViewEvents 
and RequestEvents 




Request PlocementListener 

to put another 
ViewController on screen 



Hove TopListener do desktop 
operations os appropriate 



Fire appropriate 
requestEvents to servers 



Send refresh calls to 
ViewControllers and 
ApplicationMediators 



Return all JTC 
objects allocated 

I 



FIG. 52 

Design Steps for 
on ApplicotionMediotor 
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c 



Placement runtime 



click" 

J C 

AWTEvent 



□3 



^ VolidotionRules ^ 



ViewController 



(<] I o o o o I [^] 



5302 
5308 



J 



VolidationRuieExceplion 



ViewEvent ^ 



5304 



PlocementListener 



I / (data)' 



5306 

_/ 



ApplicationMediotor 



0 I e> o D> & I \>\ 



PlacementEvent 



5310- 



> 



extends 



subcloss 



> 



3 



FIG. 53 



Placement example 

Usage from ApplicationMediator 
//in on ApplicotionMediotor 
int nriojor = PlocementEvent.ADD; 
Connponent connponent = 
custonnerDetailsViewController.getComponent(); 
PlacementEvent e = new PlocementEvent(this. component, major); 
firePlocementEvent(e); 

FIG. 54 



— ► Usage from PlocementListener 

public doss MyProgrom implements PlocementListener | 

public void placementEventPerformed(PlacementEvent e) | 
//decide bosed on source type 
switch (e.getMojorO) | 

cose PlocementEvent.ADD: 

if (e.getSourceO instonceof PreferencesAm) 
ponell.addf Center", e.getComponentQ); 

else ponel2.Qdd("A", e.getComponent()); 
breok; 

cose PlocementEvent. REMOVE: 
//do something else 

breok; 

I 

//etc. 
I 



FIG. 55 
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5600- 



5602- 



5604- 



5606- 



ViewControllers respond 
to getComponentO 

1 



ApplicotionMediotors control 
ordering of ViewControllers 



FIG. 56 

Design Steps for 
0 PlocementEvent 



ApplicotionMediotors 
fire PlocementEvents 



PlocennentListeners select the 
proper innplennentotion ond place 
the Conaponent on the screen 



5700 



TopListener runtime 



"click" 





1 « 1 

r Inl 1 r , 1 


\ 


1 1 " 1 


1 — 1 

1 ^ ! 

1 1 





c 



VolidotionRules 




lounch 



exit 



FIG. 57 



desktop 



browser 



reconfigure 
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Transporter 

This class implements the JTC and RequestEventListener interfaces 
Its primary function is to map RequestEvents to Destinations. 
♦Typically ApplicotionMediotors fire RequestEvents and Destinations process 
them 

Add a Transporter to on ApplicationMediator to listen for RequestEvents 



Transporter t = new Transporter(); 
ApplicotionMediotor am = new ApplicotionMediotorQ; 
am.addRequestListener(t); 

The ApplicotionMediotor will fire RequestEvents 

RequestEvent r = new RequestEvent(source. mojor, minor, data); 
try I 

fireRequestEvent(r); 
catch (RequestException yikes) \\ 

FIG. 67 
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Destination 



— ► RequestEvents ore identified by 

♦ mojor code - represents o family of Requests 

♦ minor code - represents a specific Request 

— ► Destinations ore added to the Transporter os DestinotionListeners 

specifing o major code for RequestEvents they ore interested in receiving 
—►The destination is colled when the major code of the RequestEvent 
motches the destination major code 



— ► Multiple Destinations con listen for the some RequestEvent major code 

♦ processed FIFO/FESP (first in first out, first exception stop forwarding) 

♦ results of one Destination con be passed to the next Destination 



Destinations and nnajor codes 

Special major codes 

♦ wildcard 

■ major code indicates the Destination is interested in all and any RequestEvents 

■ processed ofter specific major codes hove been matched. 

♦ priority 

■ major code indicates the Destination is interested in oil requests end should be given 
priority. 

■ processing performed before specific major codes and wildcards 
For exomple 

Tronsporter t = new Transporter(); 
t.oddDestinationListener new WildDestinotion ()); 

t.oddDestinotionListener ^"Loons", new EJBDestination()); 
t.oddDestinationListener ("!", new PriorityDestination()); 

//later 

RequestEvent r = new RequestEvent(this. "Loons", " null); 
try I 

fireRequestEvent(r); 
catch (RequestException yikes) || 

^ The RequestEvent *V" will be sent to PriorityDestinotion 1st. EJBDestination 2nd, 
ond WildDestinotionO 3rd, ossuming no RequestExceptions are thrown. 



EJBDestination d = new EJBDestination(); 
Transporter t = new Transporter(); 
String major = "Loons"; 
t.oddDestinotionListener(major, d); 



FIG. 69 



FIG. 70 
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( START ) 



Call getJTCs 
ond get Vector 
of JTC objects 



7500 



YES 




7506 



Use entry(i) 



7524 




7528 

Listen 
for events 
ond debug, 
log. troce. 
sinnulote 



C RETURN ) 



7520 

'Is^ 
instonceof 
Jronsporter^^ 




Add OS 
RequestListner 

7522 



hookAWts with 
ConDponent 



Add OS 
RequestListener 



hookAWts with 
Component 



7518 



7510 



7512 
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7706- 



Get list of 
Components in 
Container XYZ 




Use 
Component(i) 



Hook 
the Connponent 
XYZ 



7714 



C RETURN ) 



7708 



-0 



Hook 
the Component{i) 

I 
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Data Objects 

y/The ApplicotionMediotorlmpI will forword the refresh (defoult) 

tfor each: ApplicationMediotor -> refresh(datQ) 
for each: ViewController -> refresh(doto); 

FIG. 79 



>/The ViewController will updote the GUI 

public void refresh(Object doto) | 
//this example uses o keyVoiue pair doto model 

if (data -= null) return; 
else refresh{(KeyValue) data); 

public void refresh (KeyVoiue doto) | 

nomeField,setText(dota.get("CustomerNome")); 
idField.setText(datQ.get("Customerld")); 
repoint(); //if necessary 

FIG. 80 



Doto Objects 

^How con we odd o new data model (i.e. real objects)? 

public void refresh(Object data) | 
if (doto == null) return; 
else if (doto instonceof Vector) | 
refresh((Vector) data); 

else if (data instonceof KeyVoiue) \ 
refresh((KeyValue) data); 

^ FIG. 81 



public void refresh(Vector doto) \ 
//I know what they ore 
Customer c = (Customer) dato.elementAt(O); 
ID id = (ID) data.elementAt(l); 
nameField.setText(c.getName()); 
idField.setText(id.toString()); 
repaint(); //if necessary 

' FIG. 82 



79/119 
# AUS990339US8 



More on data 



8304 

\ 

f ApplicotionMediator J 
? — ' — 



property 
chonge 




c 



8300 



ViewController 



1. Named methods 

public double get CustomerNome() 
Implicit doto model ond ViewEvent 
ve.setDotoC'Mr. Chips"); 
fireViewEvent(ve); 

3. Explicit doto model ond ViewEvent 
dota.putC'lASTNAME", "Chips"); 
ve.setData(datQ); 
fireViewEvent(ve); 

4. Property Change events 
^doto.put("SOLUTION'\ "JTC"); 



osync streaming RMI 



FIG. 83 
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C START ) 



8400 
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8406- 
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8410- 



ApplicotionMediotor receives 
ViewEvent from ViewController 




Creole TopEvent with 
proper mojorCode 



Fire TopEvent 



Invoke Set of TopListeners 



TopListener receives TopEvent 




8414 



Exit 

the opplicotion 



8418 



Disploy message 
for opplicotion 



, 8422 

Disploy title 
for opplicotion 



, 8426 

Execute other 
opplicotion 



FIG. 84 
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( START ^ 
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ApplicotionMediator 
receives ViewEvent 
from ViewController 



Create 
PlocementEvent with 
proper mojor code. 



Fire PlocementEvent 



Invoke 
PlocementListener 



PlocementListener 
receives PlocementEvent 



C END ) 
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Add ViewController's 
component to a visual 
container and repaint. 



I 



8518 



Remove ViewController's 
component from o visuol 
container and repaint. 



FIG. 85 
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Handling AWTEvents 



C START ) 



AWTEvent arrives 



Hondle AWTEvent by 

monipuloting GUI 
occording to GUI spec 



Apply 
ValidationRules 




FIG. 86 
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Applying ValidotionRules 
( START ) 



8708- 



fireViewEvent 
C START ) 



Select Unopplied 
Volidotion rule for 
the Component 



-8700 



8800 




Apply 
ValidotionRule(i) to 
Component's volue 




Success? 
8706 I NO 



Throw Exception 



C RETURN ) 
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ViewListener(i).viewEventPerformed 
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( START ^ 



Creole 
ViewControllers 



Respond 
to Events 



( END ) 

FIG. 89 



Application Manager 
C START ) 



Doto Event 



For Eoch 
ViewController Coll 
Refresh (Doto) 



( END ) 

FIG. 90 
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Application Manager 
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9104- 



( START ) 



Add Listener 



Find 
Listener Type 



Add Listener 
Type to Vector 



( end ) 
FIG. 91 



Application Manager 
( START ) 



Remove Listener 



Find 
Listener Type 



Remove Listener 
From Vector 



( END ) 

FIG. 92 
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Application Manager 
( START ) 
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Get/Set 
PernDission 
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Process 
Permission 
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FIG. 93 



9408- 



Application Manager 
( START ) 



ViewEvent 
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refresh(Object data) 
in ApplicationMedictor 



( START ) 



Refresh Object doto 

i 



Access data 



For eoch 
ApplicationMediator(i) 



ApplicotionMediator(iVrefresh 
(Object doto) 




YES 



For each 
ViewController(i) 



ViewControlier(i). refresh 
(Object data) 



YES 
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RequestListener(i).requestEventPerformed 
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refresh(Object data) 
in ViewController 
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Refresh (Object dolo) 
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( START ) 



Creole Top 
ApplicotionMediotor 



Add TopListeners 



Add RequestListeners 



Add PlocementListeners 



Add ViewListeners 



Creote 2nd Level 
ApplicotionMediotor 



Clone TopListeners 



Clone RequestListeners 



Clone PlocennentListeners 



Add Top 
ApplicotionMediotor 
OS the ViewListener 




Creote ViewController 



Add porent Level 
ApplicotionMediotor 
OS the ViewListener 



FIG. 99 




( END ) 



Creote 3rd Level 
ApplicotionMediotor 



Clone TopListeners 



Clone RequestListeners 



Clone PlocementListeners 



Add Upper Level 
ApplicotionMediotor 
OS the ViewListener 



■9926 



-9928 



9930 



■9932 



■9934 



89/119 

0 AUS990339US8 # 



C START ) 



10000- 
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Receive user 
oclion input 



Creole and fire 
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ViewController receives 
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ViewController creates 
ond fires ViewEvent 
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ApplicotionMediotor 
receives ViewEvent 
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Process ViewEvent 
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processing? 
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receives ViewEvent 
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ApplicotionMediotor 
state stonzqs 



Build 0 multi- 
dimensionol List of 
the config file 



Process events 
and calls 
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Encoding ApplicotionMediotors 

—►SI: (VE.source==vc1 && VE.mojor==A && VE.minor==B) => 
(RE.major=C RE.minor=D RE.data=VE.data RE.fireS) 

if event source is vcl with A.B as major/minor then 

fire sync request with C.D nnojor/nninor ond use doto from event) 

— ^52: VE.source==vc4 && VE.mojor==5) . ==> (TE.nnajor=3 TE.fire) 
if event source is vc4 with 5 as naojor then 
fire top event with mojor 3 

-►S3: (Refresh) ==> (VC.i.refresh(Refresh.dato)) 

if refresh(dota) occurs, then refresh oil view controllers with the 
some doto, but not the other opplicotion mediotors 

— S4: (VE.source==vcA) = = > (RE.major="set"RE.fireA) && 

(PE.mojor=PE.ADD PE.source=vcB PE.fire) && (VC.vcB.refresh(RE.data)) 
if event source is vcA. then fire osync request, then fire placement ^ 
event, then refresh the newly placed view controller with the data 
returned with the request 

FIG. 1 02 
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writeObject(currentAtlribute) 


Serialize 

10504 
\ 


BoseOoto 


BoseSeriolizer 





currentAttribute.writeExternol() 




10506 



serializer.writeObject{currentAttribute) 

FIG. 1 05 



Externolizoble 



SeriolizerIF 
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Deserialize 
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S 
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10604 

\ 


readObjectO 




BoseDota 




BaseSeriolizer 





serializer.readObjectO 




currentAttribute.readExternal() 
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10700 

packoge com.ibm.jtcx.seriQiizotion; 

import jova.io.Externalizable; 

import jovo.io.lOException; 

import jovo.io.Objectlnput; 

import jovQ.io.ObjectOutput; 

* Defoult type comment. 

* <P> INVARIANT: 
V 

public doss BoseDoto implements Externolizoble } 
privote Object[] dote = null; 

A* 

* BoseDoto constructor comment. 

V 

public BoseDotoO \ 
this(O); 

/** 

* BoseDoto constructor comment. 

* ©porom dotoArroy javo.lang.Object[] 

V 

public BoseDoto(int count) | 
superQ; 

setDoto(new Object[count]); 

A* 

* Defoult method comment. 
* 

* <P>PRE: 

* <P>POST: 

* 

* ©return Parameter not modified 

* ©return javo.long.Object[] 

*/ 

public finol Object[]. getDoto() \ 
return data; 

I 

FIG. 107 A 
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10700 

» Default method comment. 
* 

* <P>PRE: 

* <P>POST: 

* 

* ©return Parometer not modified 

* ©return jovo.long.Object 

* ©porom index int 

V 

public final Object getData(int index) | 
Object retVol = null; 

if ((dote != null) && (index < dotclength)) | 
retVol = datG[index]; 



return retVol; 

I 

* Defoult method comment. 
♦ 

* <P>PRE: 

* <P>POST: 

♦ 

* ©return Parometer not modified 

* ©porom in Objectlnput 

*/ 

public void readExternal(Ob]ectlnput in) 

throws ClassNotFoundException, iOException \ 

setDato((Object[])in.reodObject()); 

I 

A* 

* Default method comment. 

* <P>PRE: 

* <P>POST: 

* ©return Parameter not modified 

* ©porom datoArroy java.lang.Object[] 

*/ 

public final void setDota(Object[] dotoArroy) | 
doto = dotoArroy; 

FIG. 107B 
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10700 



A* 

* Default method comment. 
* 

* <P>PRE: 

* <P>POST: 
* 

* ©return Parameter not modified 

* @param index int 

* @param dataElement javo. long. Object 

*/ 

public final void setData(int index, object dataElement) | 
if ((data != null) && (index < dato.length)) | 
data[index] = datoElement; 

A* 

* Defoult method comment. 
* 

* <P>PRE: 

* <P>POST: 

* 

* ©return Porometer not modified 

* ©param out ObjectOutput 
*/ 

public void writeExternal(ObjectOutput out) throws lOExcept 
out.writeObject(getData()); 



FIG. 107C 
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10800 



pockoge com.ibm.jtcx.seriolizotion; 

import jovo.io.Externalizoble; 

import jovcioJOException; 

import javo.io.Objectlnput; 

import jovG.io.ObjectOutput; 

import jovo.math.BigDecimol; 

import jovo.math.Biglnteger; 

import jova.util.Dote; 

import jova.util.Enumeration; 

import jovo.util.GregorianColendor; 

import jovo.util.Hoshtable; 

import jovo.util.SimpleTimeZone; 

import jovo.util.TimeZone; 

import jovo.util.Vector; 

A* 

* Bose doss of doto objects thot require smoll seriolizotion. The 

* ottributes of the doto object ore stored in on orroy and the elements 

* of the orroy ore written individuolly. 
* 

* <P>INVARIANT: 
V 

public class BoseDotoS extends BoseDato implements Externolizable | 

/- 

* Default constructor. 

V 

public BoseDotoS() | 
^ superQ; 

/*♦ 

* Creates a new <code>BaseDotaS</code> object with o data array of 

* size <code>count</code>. 
* 

* ©porom count the size of the data array containing the attributes 

V 

public BaseDataS(int count) | 
super(count); 

FIG. 1 08A 
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I 

A* 

* Reads the orray of data elements from the streom. The responsibility 

* of reoding the individual element is left to the 

* <code>BaseSeriolizer</code> via <code>readObject{)<code>. 
* 

* ©param in the input stream thot contains the serialized object 

* ©exception ClossNotFoundException thrown if 

* <code>BaseSeriali2er</code> fails to reod the object from the streom 

* ©exception lOException thrown if 

* <code>BaseSeriolizer</code> foils to read the object from the stream 

* ©see BoseSeriolizerjjfreodObject 

V 

public void reodExternal(Objectlnput in) 

throws ClossNotFoundException. lOException | 

int size = in.readShort(); 

if (size -1) I 

setDota(null); 

I else \ 

Object[] orray = new Object[size]; 

for (int i = 0; i < size; i++) j 

arroy[i] = BaseSerializer,getlnstance().readObject(in); 



I 



setData(arroy); 



I 

A* 

* Writes the array of data elements. The responsibility of writing the 

* data elements is left to <code>BaseSerializer</code> via 

* <code>writeObject()</code>. 
♦ 

* ©porom out the output stream to which the doto elements will be 

* written 

*/ 

public void writeExternal(ObjectOutput out) throws lOException | 
Object[] array = getData(); 

if (array == null) | 

out.writeShort(-l); 

I else I 

out.writeShort(orray.length); 

for (int i = 0; i < arroy.length; i++) | 

BaseSerializer.getlnstance().writeObject(out. array[i]); 

I ^ 

10800 

FIG. 1 08B 
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pockoge com.ibm.jtcx.seriolizotion; 

import jovo.io.IOException; 
import jovo.io.Objectlnput; 
import jovo.io.ObjectOutput; 

A* 

* The interfoce for those dosses that serialize objects to and from 

* 0 stream. The object that implements this interface should write 
» just the object's attributes, not any other descriptive information 

* about the object. Typically, a <code>SerializerlF</code> knows how , 
» to serialize a specific class. 

*/ 

public interfoce SerializerIF \ 

A* 

* Reads on object from the stream. 
* 

* ©return The object that was read. 

* ©poram in the input stream containing the object 

* ©exception java.io.lOException thrown if the stream fails 

* ©exception jovo.long.CiassNotFoundException thrown if the stream 

* foils 

*/ 

Object readObject(Object Input in) throws lOException. ClossNotFoundExceptio 
A* 

* Writes the given object to the stream. 
« 

* ©porom out the output stream into which the object will be written 

* ©porom element the object that will be written to the stream 

* ©exception jovo.io.IOException thrown if the stream foils 

*/ 

void writeObject(ObjectOutput out. Object element) throws lOException; 

FIG. 109 
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pQckoge com.ibm.jtcx.seriolizotion; 

import jovo.io.*; 

import jovo.moth.Biglnteger; 

import jovo.moth.BigDecimol; 

import jova.util.Dote; 

import jovo.util.GregorianCclendar; 

import jovcutiLHoshtoble; 

import jovo.util.SimpleTimeZone; 

import jovo.util.StringTokenizer; 

import jovo.util.TimeZone; 

import jova.util.Vector; 



The <code>SeriolizerlF</code> thot is used as the base level 
serializer. It contains three tables used to serialize objects: 
<br><ul> 



<li> codeToble: the table containing the serialization code of 

an object based on the name of the class 
<li> nomeTable: the toble containing the name of the cioss 

based on the serialization code 
<li> seriaiizationToble: the table containing the seriolizer of 
on object based on its serialization code 



* </ul> 

* <br><br> 

* <code>BaseSerializer</code> delegates the responsibility of 

* serializing the objects to the <code>SerializerIF</code> associated 

* with thot class or to the object itself if it implements 

* <code>Externalizable</code>. 

public class BoseSeriolizer implements SerializerIF \ 
static private final int NULLOBJECT = 0; 
static private final int OTHER = OxOOff; 

static private final String HASHTABLE_SER = "ClossNameHash.ser"; 
static privote final String INLFILE = "ClassNames.ini"; 

static private Hoshtable codeToble = null; 

static private Hoshtable nomeTable = null; 

static private Hoshtable seriolizerToble = null; 

static private BoseSeriolizer instance = null; 

class BigDecimaiSeriolizer implements Serializer IF | 



public Object read0bject(0bjectlnput in) throws ClossNotFoundException, lOException \ 



/■ 
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int scole = in.reodShortQ; 
int size = in.reodShorl(); 
byte[] bytes = new byte[size]; 
in.reGdFully(bytes); 

Biglnteger temp = new Biglnteger(bytes); 
return new BigDecinnol(tennp, scole); 

public void writeObject(ObjectOutput out, Object elennent) throws lOException | 
BigDecimol bigD = (BigDecinnal)element; 

int scole = biqD.scQleQ; 
bigD.setScale{0); 



class BiglntegerSeriolizer innplements SeriolizerlF | 

public Object reodObject(Objectlnput in) throws ClossNotFoundException. lOException 

int size = in.reodShortQ; 
byte[] bytes = new byte[size]; 
in.reQdFully(bytes); 

return new Biglnteger(bytes); 

public void writeObject(ObjectOutput out, Object elennent) throws lOException | 
byte[] bytes = ((Biglnteger)element).toByteArroy(); 

out.writeShort(bytes.length); 
out.write(bytes); 



doss BooleonSeriolizer implements SeriolizerlF | 

public Object readObject{Objectlnput in) throws ClossNolFoundException. lOException 

int value = in.readByte(); 

return (volue == 1) ? Booleon.TRUE: Booieon.FALSE; 

public void writeObject(ObjectOutput out, Object element) throws lOException \ 
out.writeByte{({Boolean)element).booleonValue() ? 1 : 0); 




out.writeShort(scole); 

out.writeShort(bytes.length); 

out.write(bytes); 



FIG. 1 1 0B 
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doss ByteSeriolizer implements SeriolizerlF | 

public Object read0bject(0bjectlnput in) throws ClossNotFoundException, lOException | 
byte value = in.reodByte(); 



doss ChorocterSeriolizer implements SeriolizerlF | 

public Object readObject(Objectlnput in) throws ClossNotFoundException, lOException { 
chor volue = in.reodChorQ; 

return new Charocter(volue); 

public void writeObject(ObjectOutput out, Object element) throws lOException | 
out.writeChor(((Charocter)element).charValue()); 

I ' 

doss DoteSeriolizer implements SeriolizerlF J 

public Object reodObject(Objectlnput in) throws ClossNotFoundException lOException | 
long value = in.readLong(); 

return new Dote(vQlue); 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
out.writeLong(((Date)element).getTimeO); 

\ ^ 

doss DoubleSeriolizer implements SeriolizerlF } 

public Object reodObject(Objectlnput in) throws ClossNotFoundException. lOException j 
double volue = in.reodDouble(); 

return new Double(value); 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
out.writeDouble(((Double)element).doubleValue()); 




FIG. HOC 
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class FloatSerializer implements SeriolizerlF j 

public Object reodObject{Objectlnput in) throws ClossNotFoundExceplion. lOException | 
floot value = in.readFloat(); 

return new Float(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException | 
out.writeFloat{({Floot)element).floatVolue()); 

doss GregorionColendorSerializer implements SeriolizerlF \ 

public Object reodObject(Objectlnput in) throws ClossNotFoundException, lOException | 
long time = in.readLongQ; 
Dote date = new Date(time); 
SeriolizerlF serializer = BaseSerializer.getinstanceQ; 
TimeZone tz = (TimeZone)serializer.reodObject(in); 

GregorionCalender gColender = new GregorianColendar(tz); 
gColendor.setTime(date); 

return gCalendar; 

public void wrIteObject(ObjectOutput out. Object element) throws lOException \ 
GregorianColendor temp = (GregorionCalendar)element; 

Dote dote = temp.getTimeQ; 
TimeZone tz = temp.getTimeZoneQ; 

out.writeLong(dote.getTime()); 

SeriolizerlF seriolizer = BoseSeriolizer.getlnstance(); 

serializer.writeObject(out, tz); 

class IntegerSeriolizer implements SeriolizerlF | 

public Object reQdObject(Objectlnput in) throws ClossNotFoundException, lOException j 
int value = in.readlnt(); 

return new Integer(value); 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
out.writelnt(((lnteger)element).intVolue()); 

class LongSeriolizer implements SeriolizerlF | 

public Object readObject(Objectlnput in) throws ClossNotFoundException, lOException J 

FIG. 1 1 0D 
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long value = in.reodLongQ; 



return new Long(value); 

public void writeObject{ObjectOutput out, Object element) throws lOException | 
out.writeLong(((Long)elennent).longVQlue()); 

class ObjectArraySerializer innplennents SeriolizerIF j . . 

public Object readObject{Object!nput in) throws ClossNotFoundException, lOException \ 
int size = in.readShort(); 

Object[] array = new Object[size]; 
for (int i = 0; i < size; i++) \ 

SeriolizerIF seriolizer = BaseSerializer.getlnstonce(); 

array[i] = serializer.readObject(in); 

return orroy; 

public void writeObject(ObjectOutput out. Object elennent) throws lOException | 
Object[] orroy = (Object[])element; 

out.writeShort(arrayJength); 

for (int i = 0; i < orroy length. i++) \ 

SeriolizerIF seriolizer = BaseSeriolizer.getInstance(); 

serializer.writeObject(out. arroy[i]; 



class ObjectSeriolizer innplennents SeriolizerIF } 

public Object reodObject(Objectlnput in) throws ClossNotFoundException. lOException \ 
return in.readObject(); 

public void writeObject(ObjectOutput out, Object elennent) throws lOException | 



doss ShortSeriolizer innplennents SeriolizerIF | 

public Object readObject(Objectlnput in) throws ClossNotFoundException. lOException | 
short value = in.readShort(); 



out.writeObject(elennent); 



return new Short(value); 



FIG. 1 1 0E 
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public void writeObject(ObjectOutput out, Object element) throws lOException \ 
out.writeShort(((Short)element).shortVolue()); 



class SimpleTimeZoneSericlizer implements SeriolizerlF j 

public Object readObjecl(Objectinput in) throws ClossNotFoundException. lOException | 
int offset = in.reodlntQ; 

SeriolizerlF serioiizer = BaseSeriolizer.getlnstonce(); 
String id = (String)serializer.readObject(in); 

return new SimpleTimeZone(offset, id); 

public void writeObject(ObjectOutput out, Object element) throws lOException { 
SimpleTimeZone temp = (SimpleTimeZone)element; 

out.writelnt(temp.getRawOffset()); 

SeriolizerlF serioiizer = BoseSeriolizer.getlnstonceQ; 

serializer.writeObject(out, temp.getlDQ); 

class StringSerializer implements SeriolizerlF \ 

public Object reodObject(Objectlnput in) throws ClossNotFoundException. lOException | 
int size = in.reodShortQ; 
byte[] bytes = new byte[size]; 
in.reodFully(bytes); 

return new String(bytes); 

public void writeObject(ObjectOutput out. Object element) throws lOException j 
byte[] bytes = ((String)element).getBytes(); 

out.writeShort(bytes.length); 
out.write(bytes); 

class VectorSeriolizer implements SeriolizerlF | 

public Object reQdObject(Objectlnput in) throws ClossNotFoundException, lOException | 
int size = in.reodShortQ; 



Vector vector = new Vector(size); 
for (int i = 0; i < size; i++) | 

SeriolizerlF serioiizer = BaseSeriolizer.getlnstonce(); 

vector.oddElement(serializer.readObject(in)); 



FIG. 1 1 0F 
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return vector; 

public void writeObject(ObjectOutput out, Object element) throws lOException 
Vector temp = (Vector)element; 

Object[] array = new Object[temp.size()]; 
for (int i = 0; i < orray.length; i++) | 
arroy[i] = temp.elementAt(i); 

out.writeShort(orrQy.length); 

for (int i = 0; i < orray.length; i++) \ 

SeriolizerlF seriolizer=BaseSerioli2er.getlnstonce(); 

serializer.writeObject(out, Qrray[i]); 



* Default constructor. The constructor is private because this is a 

* singleton doss. When the object is constructed, it initializes its 

* tables. 

V 

privote BaseSerializer() \ 
initQ; 

A* 

* Adds the given elements to the three tobies. 
* 

* ©porom clossNome the nome of the doss 

* ©parom code the code for the given doss 

* ©porom seriolizer the object responsible for serializing the given 

* doss 

*/ 

private void addDataToTobles(String dassNome, Number code. SeriolizerlF seriolizer) | 
getCodeTable().put(code, clossNome); 
getNameTable().put(className. code); 

if (seriolizer != null) | 

getSerializerTable().put(code. seriolizer); 



FIG. 11 OG 
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A* 

* Creoles the codes ond seriolizer objects for the defoult seriolizotion 

* classes end odds them to the tobies. The tobies ore then written to 

* 0 seriolized file. 

V 

private void createDefauItTables() J 

QddDotoToTables(BigDecinnal.class.getNonne(), new Byte((byte)1), new 
BigDecinnoiSeriolizerO); 

oddDotoToTQbles(Biglnteger.closs.getNGme{). new Byte({byte)2), new BiglntegerSerializer()); 

oddDotoToToblesfBooleon.closs.getNanneQ. new Byte({byte)3). new BooleonSeriolizer()); 

addDataToTables(Byte.closs.getNome(), new Byte((byte)4), new ByteSerializer()); 

oddDotoToTobles(Charocter.closs.getNome(). new Byte((byte)5), new CharocterSeriolizer()); 

oddDatoToTobles(Date.class.getNanne(). new Byte((byte)6), new DoteSeriolizerQ); 

addDatoToTQblesfDouble.closs.getNome(), new Byte((byte)7). new DoubieSerializerQ); 

addDatoToTables(nbat.class.getNanne(). new Byte((byte)8), new FlootSeriolizer()); 

addDataToTables(GreqorianCalendar.closs.getName(). new Byte((byte)9), new 
GregorionColendorSeriolizerQ; 

addDataToTables(Integer.closs.getNanrie(), new Byte((byte)10), new lntegerSerializer()); 

oddDotoToToblesfLong.closs.getNonneO, new Byte((byte)1 1). new LongSerializer()); 

oddDotaToTobles(Short.clQss.getNonne(), new Byte((byte)l2). new ShortSerioiizerO); 

addDataToTables(SinnpleTinneZone.closs.getName(), new Byte((byte)13). new 
SinnpleTinneZoneSerializerO); 

oddDotaToTobles(String.closs.getNanne(). new Byte((byte)14). new StringSeriolizerQ); 

addDataToTables(Vector.class.getNannep, new Byte((byte)15). new VectorSeriolizerQ); 

oddDotoToTables(Object.closs.getNome(). new Byte({byte)16). new ObjectSeriolizer()); 

writeToblesO; 

I 

/** 

* Returns on instance of the toble of doss names, keyed by their code. 

* If the table does not exist, it is created. 

* ©return The table of class nomes. 

V 

protected Hoshtoble getCodeTable() | 
if (codeToble == null) | 

codeToble = new Hashtable(); 

' FIG. 1 1 0H 
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return codeToble; 

* Returns an instance of <code>BaseSerializer</code>. 

* ©return An instonce of <code>BaseSerializer</code>. 

V 

public static SerializerIF getlnstanceQ | 
if (instance == null) J 

instance = new BaseSeriolizerO; 

I 

return instance; 

I 

/** 

* Returns on instance of the toble of codes, keyed by their 

* corresponding class name. 

* if the table does not exist, it is created. 
* 

* ©return The table of codes. 

*/ 

protected Hoshtable getNonneToble() | 
if (nomeToble == null) | 

nonneTable = new Hashtoble(); 

I 

return nomeToble; 

i 

A* 

* Returns on instance of the table of seriolizers. keyed by their 

* corresponding code. 

* If the table does not exist, it is created. 
* 

* © return The table of doss names. 

*/ 

protected Hoshtable getSerializerToble() { 
if (serializerToble == null) \ 

seriolizerToble = new Hashtable(); 

I 

return seriolizerToble; 

* Initializes the hoshtable from either a serialized hoshtoble or from 

* on ini file. 

*/ 

FIG. 1 1 01 



108/119 
AUS990339US8 



11000 

protected void init() { 

File seriolizedFile = new File(HASHTABLE_SER); 
File iniFile = new File(INLFILE); 

if (seriolizedFile.existsQ) \ 

reodSerioli2edFile(seriGlizedFile); 

I else j 

if (iniFile.existsQ) | 

readlniFile(iniFile); 

creoteDefoultToblesO; 

* Gets the value of the serialization code fronn the table bosed on 

* the className provided. The value returned con either be a 

* <code>Byte</code> or an <code>Integer</code>. The return value 

* will be a <code>Byte</code> if the classNome is one of the base 

* data types. 
* 

* ©return The serialization code of the ciassNonne. 

* ©poronn clossNome the nanne of the class 

V 

private Nunnber lookupCode(String clossNanne) \ 
Number code = null; 

if (className != null) | 

code = (Number)getNomeTable().get(className); 

return code; 

I 

A* 

* Looks up the hashcode in the table and returns the String value of 

* the hashcode. If the hashcode does not exist in the table 

* <code>null</code> is returned. 
* 

* ©return The object that was stored in the table with the given 

* hashcode. 

* ©porom hashcode the hashcode that will be used to look up the value 

FIG. 1 1 0J 
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private String lookupNome(Number code) \ 
String clossNonne = null; 

if (code != null) { 

clossNome = (String)getCodeTable().get(code); 

return clossNonne; 

* Default nnethod comnnent. 

* <P>PRE: 

* <P>POST: : 

* 

* ©return Poranneter not modified 

* ©return conn.ibnn.jtc.util.SerializerlF 

* ©porom code int 

V •■ .. ... .-. 

private SeriolizerlF lookupSerializer(Number code) | 
SerioIizerlF serializer = null; 

if (code != null) | 

serializer = (SerializerlF)getSerializerTable().get(code); 

return serializer; 

* Default method comment. 
♦ 

* <P>PRE: 

* <P>POST: 

* 

* ©return Parameter not modified 

* ©parom iniFile java.io.File 
*/ 

private void readlniFile(File iniFile) | 
BufferedReoder in = null; 

try I 

in = new BufferedReader(new FileReader(iniFile)); 

for (String inline = in.readLine(); inline != null; inline = in.readLine()) | 
String trimline = inline.trim(); 
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if ((trimLine.lengthO > 0) && 

ItrimLine.stortsWithC'fO) I 

StringTokenizer tokenizer = new StringTokenizer(trimLine); 

Siring clossNonne = tokenizer.nextToken(); 

Integer code = new lnteger(clossNanr^e.hashCode()); 

SeriolizerlF seriolizer = null; 

if (tokenizer.hosMoreTokensO) | 

String serioiizerNonne = tokenizer. nextTokenQ; 

try I 

seriolizer = {SeriolizerlF)Closs.forNome{serializerNome).newlnstance(); 
\ catch(Exception e) | | 

addDatoToTobles(classNanne, code, seriolizer); 

\ cotch (Exception throwAwoy) | 
I finolly i 
try i 

in.close(); 
I catch (Exception throwAwoy) | 

I 

writeToblesO; 

A* 

* Reods the object from the streonn by first reading the code for the 

* element then reods the oppropriote doto for that object. 
* 

* ©return The object that was read from the stream. 

* ©porom in the input streom thot contoins the object 

*/ 

public Object readObject(Objectlnput in) 

throws ClossNotFoundException, iOException | 
Object retVol = null; 
Number code = null; 

byte boseCode = in.reodByte(); 

FIG. 1 1 0L 
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if (boseCode == NULL_OBJECT) | 
retVol = null; 

I else I 

if (boseCode != OTHER) j 

code = new Byte(baseCode); 

j else I 

int secondCode = In.reodlntQ; 
code = new Integer(secondCode); 

SeriolizerIF seriolizer = lookupSeriQlizer{code); 
if (seriolizer != null) \ 

retVol = seriolizer.readObject(in); 

I else I 

String clossNome = lookupNome(code); 
try { 

retVol = Closs.forNome(clossNome).newlhstonce(); 

if (retVol instonceof Externolizoble) \ 

((Externalizoble)retVol).reodExternol(in); 

I else j 

retVol = in.reodObject(); 
I catch(Exception e) \ 



return retVol; 



* Reods the file contoining the seriolized hoshtobles of doto. 

* ©porom seriolizedFile the file contoining the seriolized tobies 
*/ 

privote void reodSerializedFile(File seriolizedFile) | 
ObjectlnputStreom in = null; 
try I 

in = new ObjectlnputStreom(new FilelnputStreom(seriolizedFile)); 
codeToble = (Hoshloble)in.readObject(); 
nomeToble = (Hoshtoble)in.reodObject(); 
seriolizerToble = (Hoshtoble)in.reodObject(); 

FIG. 11 OM 
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catch (Exception throwAway) j 
finally | 

in.close(); 
I catch (Exception throwAway) \ \ 

if ((codeTable == null) |1 

(nomeTable == null) || 
(seriolizerTable == null)) | 



I 



createDefoultToblesO; 



* Writes the given object to the stream. First, the code representing 

* the type of the object is written, then the doto within the object 

* is written. 
* 

* ©poronn out the output stream thot will contain the object 

* ©porom element the data object that will be written 

*/ 

public void writeObject(ObjectOutput out. Object element) 
throws lOException \ 

if (element -- null) j 

out.writeByte(NULl_OBJECT); 

I else I 

String ciossNome = element. getClass().getName(); 
Number code = lookupCode(className); 

if (code != null) | 

if (code instanceof Byte) j 

out.writeByte(code.byteValue()); 
\ else if (code instanceof Integer) | 

out.writeByte(OTHER); 

out.writelnt(code.intVolue()); 

I 

SeriolizerIF seriolizer = lookupSeriolizer(code); 

if (seriolizer != null) | 

serializer.writeObject(out, element); 
I else if (element instanceof Externalizoble) } 

((Externalizable)element).writeExternal(out); 

fig: 1 1 0N 
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I else I 

out.writeObject(element); 

j else I 

if (element instonceof Objectf]) { 

clossNome = Object[].class.getNome(); 

I else { 

className = Object.class.getNdme(); \ 

code = lookupCode(classNome); 

SeriolizerlF seriolizer = lookupSerializer(code); 

out.writeByte(code.byteValue()); 
serializer.writeObject(out. element); 



\ 

A* 

* Writes the tobies to the file. 

V 

privote void writeTables() \ 

ObjectOutpulStreom out = null; 

try 1 

File serFile = new File(HASHTABLE_SER); 

out = new ObjectOutputStream(new FileOutputStream(serFile)); 

out.writeObject(getCodeTable()); 
out.writeObject(getNameTQble()); 
out.writeObject(getSeriolizerToble()); 
out.writeObject(new Date()); 

!cotch(Exception e) \ 
finolly I 
try I 

out.close(); 
I catch(Exception e) | \ 

\ 
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